History Transaction

Service ini digunakan mendapatkan data dari transaksi QRIS yang telah di buat

Service Info

HTTP Method	POST
Service Code	12
Http Method	POST
Path	.../v1.0/transaction-history-list
Authentication	OAuth 2.0

Header Name	Tipe Data	Wajib	Deskripsi
Content-Type	String	Y	application/json
X-TIMESTAMP	String	Y	Waktu lokal klien saat ini yyyy-MM-ddTHH:mm:ss.SSSTZD format
X-PARTNER-ID	String	Y	Client’s client_id (diberikan pada saat onboarding )
X-CHANNEL-ID	String	Y	ID channel merchant
X-SIGNATURE	String	Y	Dibuat dengan algoritma asymmetric with token : Signature Generation
X-EXTERNAL-ID	String	Y	ID external merchant (tidak boleh sama di hari yang sama)

Body

Nama Field	Tipe Data	Wajib	Deskripsi
fromDateTime	Date	Y	Tanggal Awal Transaksi
toDateTime	Date	Y	Tanggal Akhir Transaksi
pageSize	String	N	Limit Dari Data yang akan di tampilkan
pageNumber	String	N	Baris dari halaman data yang akan di tampilkan
additionalInfo	Object	Y	Informasi tambahan yang diperlukan
merchantId	String	Y	Kode unik yang dimiliki setiap merchant

JSON
CURL
PHP
NODE JS
GO

{
  "fromDateTime": "2024-03-01T00:00:00+07:00",
  "toDateTime": "2024-03-31T00:00:00+07:00",
  "pageSize": "10",
  "pageNumber": "0",
  "additionalInfo": {
    "merchantId": "121xxxx"
  }
}

curl --location --request POST '../v1.0/transaction-history-list' \
--header 'x-client-key: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc' \
--header 'x-timestamp:  2024-01-16T10:54:21+07:00' \
--header 'x-signature: ga34U/0s86rGCaWEnW2/D50h4Gvkl7Axcv5zZsVq5ibGSjMS7sCr5Z4qU9OwNQ2ME0bqtJRU2WFuR/wA9efYlw==' \
--header 'x-partner-id: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc' \
--header 'channel-id:  23412' \
--header 'x-external-id: 2024-05-15T10:13:38.464Z' \
--header 'Content-Type:  application/json' \
--header 'Authorization: Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5' \
--data-raw '{
  "fromDateTime": "2024-03-01T00:00:00+07:00",
  "toDateTime": "2024-03-31T00:00:00+07:00",
  "pageSize": "10",
  "pageNumber": "0",
  "additionalInfo": {
    "merchantId": "121xxxx"
  }
}'

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '../v1.0/transaction-history-list',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "fromDateTime": "2024-03-01T00:00:00+07:00",
  "toDateTime": "2024-03-31T00:00:00+07:00",
  "pageSize": "10",
  "pageNumber": "0",
  "additionalInfo": {
    "merchantId": "121xxxx"
  }
}',
  CURLOPT_HTTPHEADER => array(
    'x-client-key: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
    'x-timestamp:  2024-01-16T10:54:21+07:00',
    'x-signature: ga34U/0s86rGCaWEnW2/D50h4Gvkl7Axcv5zZsVq5ibGSjMS7sCr5Z4qU9OwNQ2ME0bqtJRU2WFuR/wA9efYlw==',
    'x-partner-id: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
    'channel-id:  23412',
    'x-external-id: 2024-05-15T10:13:58.743Z',
    'Content-Type:  application/json',
    'Authorization: Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var request = require('request');
var options = {
  'method': 'POST',
  'url': '../v1.0/transaction-history-list',
  'headers': {
    'x-client-key': '6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
    'x-timestamp': ' 2024-01-16T10:54:21+07:00',
    'x-signature': 'ga34U/0s86rGCaWEnW2/D50h4Gvkl7Axcv5zZsVq5ibGSjMS7sCr5Z4qU9OwNQ2ME0bqtJRU2WFuR/wA9efYlw==',
    'x-partner-id': '6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
    'channel-id': ' 23412',
    'x-external-id': '2024-05-15T10:14:15.674Z',
    'Content-Type': ' application/json',
    'Authorization': 'Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5'
  },
  body: '{\n  "fromDateTime": "2024-03-01T00:00:00+07:00",\n  "toDateTime": "2024-03-31T00:00:00+07:00",\n  "pageSize": "10",\n  "pageNumber": "0",\n  "additionalInfo": {\n    "merchantId": "121xxxx"\n  }\n}'

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "../v1.0/transaction-history-list"
  method := "POST"

  payload := strings.NewReader(`{
  "fromDateTime": "2024-03-01T00:00:00+07:00",
  "toDateTime": "2024-03-31T00:00:00+07:00",
  "pageSize": "10",
  "pageNumber": "0",
  "additionalInfo": {
    "merchantId": "121xxxx"
  }
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("x-client-key", "6c57db4e-9e11-4951-9bcf-d6f177dafbcc")
  req.Header.Add("x-timestamp", " 2024-01-16T10:54:21+07:00")
  req.Header.Add("x-signature", "ga34U/0s86rGCaWEnW2/D50h4Gvkl7Axcv5zZsVq5ibGSjMS7sCr5Z4qU9OwNQ2ME0bqtJRU2WFuR/wA9efYlw==")
  req.Header.Add("x-partner-id", "6c57db4e-9e11-4951-9bcf-d6f177dafbcc")
  req.Header.Add("channel-id", " 23412")
  req.Header.Add("x-external-id", "2024-05-15T10:14:27.374Z")
  req.Header.Add("Content-Type", " application/json")
  req.Header.Add("Authorization", "Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Response

Parameter	Tipe Data	Deskripsi
responseCode	String	Kode response
responseMessage	String	Pesan response
detailData	Array	Untuk Memuat Data List
dateTime	String	Kode Unik Dari QRIS yang telah di buat
amount	Object
value	String	Jumlah total nominal transaksi.
currency	String	Mata uang.
additionalInfo	Object	Informasi Tambahan
idTransaksi	String	kode unik dari transaksi
nominal	String	Jumlah total nominal transaksi.
nominalAdmin	String	nominal admin
fee	String	Biaya tambahan
mdr	String	Biaya yang di bebankan oleh Acquirer penyedia
merchantRepo	String	Id PJP
terminalId	String	kode terminal
mid	String	Kode unik mid dari QRIS merchant
nmid	String	Kode unik nmid dari QRIS merchant
issuerReff	String	kode unik dari issuer
buyerReff	String	kode unik dari `issuerReff` dan `RRN`
brandName	String	nama brand dari issuer
imageUrl	String	logo url dari issuer
idMerchant	String	kode unik yang di miliki setiap user
merchantName	String	nama merchant yang terdaftar
merchantCriteria	String	kriteria merchant
merchantCategory	String	kategori merchant
merchantPostcode	String	kode pos merchant
namaKota	String	nama kota merchant

{
    "responseCode": "2001200",
    "responseMessage": "Successful",
    "detailData": [
        {
            "dateTime": "2024-03-01T16:39:14+07:00",
            "amount": {
                "value": "123456",
                "currency": "IDR"
            },
            "additionalInfo": {
                "idTransaksi": "5188671",
                "nominal": "123456",
                "nominalAdmin": "0",
                "fee": "0",
                "mdr": "-864",
                "merchantRepo": "9360xxxx",
                "issuerReff": "000005188670",
                "terminalId": "A01",
                "mid": "ID102300000xxxx",
                "nmid": "ID102300000xxxx",
                "buyerReff": "9360xxxx - 000005188670",
                "brandName": "SPEEDCASH",
                "imageUrl": "../pjsp/speedcash.png",
                "idMerchant": "121xxxx",
                "merchantName": "Toko kita",
                "merchantCriteria": "",
                "merchantCategory": "",
                "merchantPostcode": "61271",
                "namaKota": "SIDOARJO"
            }
        },
        {
            "dateTime": "2024-03-13T09:34:44+07:00",
            "amount": {
                "value": "30000",
                "currency": "IDR"
            },
            "additionalInfo": {
                "idTransaksi": "5193735",
                "nominal": "30000",
                "nominalAdmin": "0",
                "fee": "0",
                "mdr": "-210",
                "merchantRepo": "9360xxxx",
                "issuerReff": "000005193734",
                "terminalId": "A01",
                "mid": "ID102300000xxxx",
                "nmid": "ID102300000xxxx",
                "buyerReff": "9360xxxx - 000005193734",
                "brandName": "SPEEDCASH",
                "imageUrl": "../pjsp/speedcash.png",
                "idMerchant": "121xxxx",
                "merchantName": "Toko kita",
                "merchantCriteria": "",
                "merchantCategory": "",
                "merchantPostcode": "61271",
                "namaKota": "SIDOARJO"
            }
        },
    ]
}

List Response Code Transaction History List

Response Code	Response Message	Description
2001200	Success
4001201	Invalid field format { field name }
4011200	Unauthorized. Invalid Signature	`X-Signature` salah
4091200	Cannot use same X-EXTERNAL-ID in same day	`X-External-ID` sudah pernah digunakan di hari yang sama
4041201	Bad Request	Request header ada yang salah / kurang
4041200	Unauthorized. Client Forbidden Access API	Partner tidak dapat mengakses api terkait
4031219	Merchant Blacklisted	Merchant telah di blacklist
4041201	Transaction Not Found	Data Generate QR tidak di temukan di tanggal tersebut

History Transaction

Service Info​

Header​

Body​

Response​

List Response Code Transaction History List​

Service Info

Header

Body

Response

List Response Code Transaction History List